home *** CD-ROM | disk | FTP | other *** search
/ Internet Warrior 1993 July / Internet Warrior No. 1 July 1993 - Austin Code Works.ISO / apps / pcgopher / gopher.doc < prev    next >
Encoding:
Text File  |  1993-06-06  |  8.8 KB  |  187 lines

  1.      Client Documentation for PC w/Lan Workplace for DOS
  2.                   version 1.13
  3.                         and windows version 0.5
  4.  /*
  5.  ****************************************************************************
  6.  *Copyright 1992 Regents of The University of Michigan - All Rights Reserved*
  7.  *                                                                          *
  8.  * Permission to use, copy, modify, and distribute this software and its    *
  9.  * documentation for any purpose and without fee is hereby granted,         *
  10.  * provided that the above copyright notice appears in all copies and that  *
  11.  * both that copyright notice and this permission notice appear in          *
  12.  * supporting documentation, and that the name of The University of Michigan*
  13.  * not be used in advertising or publicity pertaining to distribution of    *
  14.  * the software without specific, written prior permission. This software   *
  15.  * is supplied as is without expressed or implied warranties of any kind.   *
  16.  *                                                                          *
  17.  *               Information Technology and Networking                      *
  18.  *                     The University of Michigan                           *
  19.  *                    1414 Catherine St. ,B1911 CFOB                        *
  20.  *                     Ann Arbor, Michigan 48109-0704                       *
  21.  *                         +1 313-747-2778                                  *
  22.  *                       FAX: +1 313-763-5144                               *
  23.  *                        help@med.umich.edu                                *
  24.  *                                                                          *
  25.  ****************************************************************************
  26.  */
  27.  
  28. I. Overview of the Internet Gopher LWP Client.
  29.  
  30. The Internet Gopher is a distributed document delivery service. The LWP client
  31. is designed to run on a PC with Lan Workplace for DOS, a NOVELL product.
  32. It allows a user to access various types of data residing on multiple
  33. hosts in a seamless fashion.  This is accomplished by presenting the
  34. user a hierarchical arrangement of documents and by using a client-server
  35. communications model.  The LWP Gopher Client allows a user on a
  36. PC to access the vast array of information available on various gopher
  37. servers.
  38.  
  39.  
  40. II. Using Gopher
  41.  
  42. To use the gopher just type "gopher".  You will be connected up to the
  43. U of M gopher server.  You can aim the Gopher client at an alternative
  44. server if you wish.  Just give the parameters on the command line like
  45. this:    gopher <host> <port>
  46.  
  47. example:   gopher gopher.micro.umn.edu 70
  48.  
  49. Note: The defaults are host:gopher.med.umich.edu
  50.                    and port:70
  51.  
  52. Note: You can also set an environment variable to use as defaults.
  53.   Use :   SET HOST=lobster.mis.udel.edu
  54.   and/or  SET PORT=70
  55.  
  56.   If you run out of environment space for this, check your DOS manual to
  57. see how to increase the size.
  58.  
  59. Note: You can also turn off the opening credit page and the closing
  60.   page by setting the environment variable 'INFO' to anything.
  61.   exp:    SET INFO=OFF
  62.  
  63.  
  64. The following commands are available in the browsing mode.
  65.  
  66. <Return>,L,<Right>  View current item.
  67. S,<Alt-F2>        Save the current item to a file
  68. P            Print the current text item to a printer ( not working )
  69. U,K,<Up>            Move pointer up.
  70. D,J,<Down>          Move pointer down.
  71. <Page Up>           Move pointer up one page ( 20 items )
  72. <Page Down>         Move pointer down one page ( 20 items )
  73. <Home>              Move pointer to first item
  74. <End>               Move pointer to last item
  75. G,<Tab>            Move pointer to a specific item number
  76. B,H,<Left>        Go back up a level.
  77. T            Go to the top level.
  78. Q,<Esc>,<Alt-F4>    Exit Internet Gopher.
  79. =            Find out where the item is located. ( Host, port, etc. )
  80. !,-            Find out where the screen you see came from.
  81. E            Change your environment variables from the program
  82.                                                   ( not working yet! )
  83. ?                   Displays a quick help screen
  84.  
  85. To use <TAB>, press tab once then you have two options:
  86.   a) Enter a number to move ( go ) to   NOTE: This doesn't select the item!
  87.   b) Enter a character.  This will move you to the first item after the one
  88.      you're on starting with the character you press.  To move back, it's
  89.      easier to just press <page up>.
  90.  
  91. Each object can be identified by what is before the item name:
  92.  
  93. >           Item is a directory.
  94. <blank>     Item is a text file.
  95. .           Item is a search index.
  96. ~        Item is a telnet session or TN3270 session.
  97. ?           Item is a CSO query
  98. #        Item is a GIF or IMAGE
  99. @        Item is a sound
  100. *        Item is a binary file to retrieve
  101. x           Item is not currently supported
  102.  
  103. While in the text viewing mode:
  104.  
  105. Q,<Esc>,<Alt-F4>     Exits view mode
  106. <Page Up>,<Up>         Move up in file about 20 lines ( kind of flakey )
  107. <Page Down>,<Space>  Move down in file about 20 lines
  108. <Home>               Go back to top of file
  109. <End>,C              Go to the end of the file ( Continuous Scroll )
  110. <Enter>,<Down>       Move down one line at a time
  111. /                    Enter text to search for
  112. n                    Search for next occurance of text
  113. p                    Search for prior occurance of text
  114.  
  115.  
  116. III. Bugs, notes and things to be implimented.
  117.  
  118. . You can not save the file from the view mode.    Exit it and press 'S'
  119.   on the files menu item.  ( Or Alt-F2 will also select the save function )
  120.  
  121. . You can get image viewers and sound players from the misc directory
  122.   on lennon:  lennon.itn.med.umich.edu  in dos/gopher/misc  if you don't
  123.   already have one...Gifdesk displays better but can't display jpeg files so
  124.   you can use Cview to be able to display anything...Just remember, if the
  125.   program you use is shareware to register it!!!
  126.  
  127. . In order to view GIFs or Images, you must set the environment variable
  128.   'VIEWER' as follows: SET VIEWER=C:\GIFDIR\GIFDESK
  129.                    OR: SET VIEWER=C:\GIFDIR\CVIEW -f -v
  130.   changing the directory pointed to and the name of the file according to
  131.   the GIF viewer you like to use...
  132.  
  133. . In order to play sounds on your PC, you must set the environment
  134.   variable 'PLAYER' to whatever sound program you like to use.    If you
  135.   have a sound card, specify the appropriate driver...
  136.   The following is an example of this:    SET PLAYER=C:\SOUND\PLAY -k09 -s
  137.   changing the directory pointed to and the name of the file according to
  138.   the sound program you like to use...
  139.  
  140. . When you enter a telnet session and don't get the information you type
  141.   displayed back to you, press <Alt-T> and change to character local echo
  142.   mode.  This change will stay even after leaving gopher so you should only
  143.   have to do it once.  Typeing 'resume' will get you back to the telnet
  144.   session.  Press '?' to see the list of options available to figure out
  145.   how to switch to local echo.
  146.  
  147. . If you get lost in a telnet session, press <Alt-T>, type 'close', then
  148.   type 'quit'.
  149.  
  150. . Running under Windows may improve the performance of the program
  151.   when you have a large amount of virtual memory in use.  It runs a lot
  152.   smoother and for a longer period of time. (This is for full screen
  153.   only, it doesn't work in a DOS Window)
  154.  
  155. . Updates are not announced, download the files again and check the
  156.   version number on the opening screen to see if it's a new version
  157.   than what you have
  158.  
  159. . The client is not gopher+ capable.  It will connect to gopher+ servers,
  160.   but won't allow the extra options...
  161.  
  162. . The client doesn't work in a DOS Window in Windows, so an actual Windows
  163.   client is being developed.  You can however run it in full screen
  164.   mode in Windows very efficiently.
  165.  
  166. . If you are using LWP v4.1, you will have to set an environment variable
  167.   for gopher to run properly.  If you loaded LWP into c:\net for example
  168.   add  SET EXCELAN=C:\NET  to your autoexec.bat file.
  169.  
  170. . If you get the error can't find file 'resolv.cfg' then set the environment
  171.   variable as follows: SET EXCELAN=C:\XLN or where ever you have your network
  172.   software installed.  This usually results when you are still running LWP4.0
  173.   or LWP4.01 software.
  174.  
  175. . Any bugs, suggestions, or comments can be sent to:
  176.                    for Dos client:   blackp@med.umich.edu
  177.             or for Windows client: leighton@med.umich.edu
  178.       both can answer questions, etc. if you can't reach the other...
  179.   and more information can be retrieved about gopher itself by anonymous
  180.             ftp from:    boombox.micro.umn.edu
  181.   or using gopher, connect to the default host ( U of Mich ) and enter
  182.   the About Gopher directory.  Then read the protocol.text.if.you.must entry
  183.   for very detailed information about how gopher itself works.
  184.  
  185.   New updates are usually unannounced, but located at:
  186.                 lennon.itn.med.umich.edu   in dos/gopher
  187.